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Element: 


Incall Service 


Attributes: 


title 


Children: 


Service 


Description: 


A container. A high level tag that marks the start and end of the XML file. Required. 






Element: 


Service 


Attributes: 


name 


Parents: 


Incall Service 


Children: 


DNIS | Service_description I Multicall | Percall | Reset 


Description: 


A container. The parameters in this container describe a service running on a particular phone 
line (DNIS). Each line running Incall Service must have a service described for that line. 
Required. 






Element: 


DNIS 


Parents: 


Service 


Description: 


The number the caller dialed to reach the application. Required. 






Element: 


Service_description 


Parents: 


Service 


Description: 


Audio. The description of the service. This audio is played to reassure the caller that they have 
dialed the right number. Fits the carrier phrase, "Hello. You have reached 
<System_description>." Required. 






Element: 


Multicall 


Parents: 


Service 


Children: 


Call_info | Authentication | Content | Choices Value_entry 


Description: 


A container. The parameters specified in Multicall are to be used as default values for all the 
calls for the service specified in Service. Any tag may be specified in Multicall. Parameters set 
here act as default values for all calls for that service until another Multicall file for that 
service is specified. Optional. 






Element: 


Percall 


Parents: 


Service 


Children: 


Call 


Description: 


A container. Contains the list of calls to be made, one call per Call tag. Required if no Multicall 
tag specified. 






Element: 


Calf 


Attributes: 


id 


Parents: 


Percall 


Children: 


Call_info | Authentication 1 Content | Choices | Value_entry I Reset 


Description: 


A container. Contains information for a specific call. Required if there is a Percall tag. 
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Element: 


Reset 


Parents: 


Service | Call 


Description: 


Resets/Cancels a particular call (if used as a child for Call) or all potential call for a 
particular service (if used as a child for Service). Optional. 






Element: 


CalUnfo 


Parents: 


Multicall | Call 


Children: 


Phone_number | Response_url 


Description: 


A container. Contains information about the call beyond the dialog. Required in either Multicall 
or Call or both. 






Element: 


Authentication 


Parents: 


Multicall | Call 


Children: 


Authentication_code_description | Authentication_code ] Expected_caller 


Description: 


A container. Contains tags that specify the information necessary for ensuring that the caller is 
authorized to use the service. Authentication is indicated if there is an Authentication_code 
passed in from the customer's application. If there is an authentication_code, there must also be 
a description of that code. Optional. 






Element: 


Content 


Parents: 


Multicall | Call 


Description: 


Audio. The content message to be played to the caller. The content may be an audio file (*.wav), 
a text file (*.txt), or raw text (enclosed in double quotes). Optional. 






Element: 


Value_entry 


Parents: 


Multicall | Call 


Attributes: 


mindigits I maxdigits 


Description: 


Audio. A description of the entry to be entered by the called party. Must fit carrier phrase, 
"Please enter..." and "You will be asked for..." Either Choices or Value_entry, but not both, 
may be specified. Optional. 






Element: 


Choices 


Parents: 


Multicall | Call 


Children: 


Choice | Transfer 


Description: 


A container. Contains information about the list of choices that will be presented to the caller 
during the call. Optional. 






Element: 


Phone_number 


Parents: 


CalUnfo 


Description: 


Phone number from which Expected_caller is expected to call. Required. 



18/52 



Element: 


Expected_caller 


Parents: 


Authentication 


Description: 


Audio. The name of the person expected to be calling from a given phone number. Optional. 








Element: 


Response_url 


Parents: 


Calljnfo 


Description: 


URL that Incall Service is to use to return status information about the call to the customer 
application. Optional. 






Element: 


Authentication_code_description 


Parents: 


Authentication 


Description: 


Audio. Description of the authentication code the caller will be asked to enter. Fits the carrier 
phrase, "Please enter <authentication_code_description>." For example, "Please enter your 
account number." Required for each Authentication tag. 






Element: 


Authe nticatio n_code 


Parents: 


Authentication 


Description: 


The digit string value of the caller's authentication cods description. That is, the 

Authentication_code is the value that the caller must enter in order to continue with the call. 
Required for each Authentication tag. 






Element: 


Choice 


Parents: 


Choices 


Children: 


Choice description | Choice_value 


Description: 


A container. Describes the choices that are available to the caller. There is usually more than 




one Choice ta£ per Choices tag^Optional. 






Element: 


Transfer 


Parents: 


Choices 


Children: 


Transferjescription | Transfer_number 


Description: 


A container. Describes the transfer option available to the caller. If there is a transfer option, 
the value that the caller presses is "0" in order to transfer. Only one Transfer tag is allowed per 
Choices tag. Optional. 






Element: 


Choice_description 


Parents: 


Choice 


Description: 


Audio. Describes the option the caller may choose. Fits the carrier phrase, "If you would like 
<choice_description>, press one." Required for each Choice tag. 
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Element: 


Choice_value 


Parents: 


Choice 


Description: 


A single digit number that indicate the touch-tone that the caller should press in order to 
select the associated choice. Note that if there is a Transfer tag, "0" cannot be used for a 
Choice_value. Required for each Choice tag. 














Element: 


Transfer_description 


Parents: 


Transfer 


Description: 


Audio. Describes the person or thing (e.g., IVR) the caller would be transferred to should they 
press zero. Required for each Transfer tag. 






Element: 


Transfer_number 


Parents: 


Transfer 


Description: 


The phone number to which the caller would be transferred, if they press zero. Required for each 
Transfer tag. 
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1. lncall_Mfile_SCl_1.Krnl 

<?xml version- 1.0'?> 
<lncall Service title="Joe's Sales M file"> 

<Service name="movie sales"> 
<DNIS>51 22900001 </DNIS> 
<Service_description>"Joe's Movie Sales"</Service_description> 

<Multicall> 
<Authentication> 

<Authentication_code_description>"movie pin''</Authentication_code_description> 
</Authentication> 

<Choices> 
<Choice> 

<Choice_description>C:\Mob\purchase_DVD.wav</Choice_description> 
<Choice_value> 1 </Choice_value> 
</Choice> 
<Choice> 

<Choice_description>c:\Mob\purcbase_movie_video.wav</Choice_description> 
<Choice_value>2</Cjoice_value> 
</Choice> 

<Choice> 

<Choice_description>C:\Mob\purchase_soundtrack.wav</Choice_description> 
<Choice_va(ue>3</Choice_value> 
</Choice> 

<Transfer> 

<Transfer_description>"Katby's pbone"</Transfer_description> 
<Transfer_number>460</Transfer_number> 
</Transer> 

</Cboices> 
</Multicall> 
</Service> 

<Service name-'theater sales"> 
<DNIS>5 1 22900003</DNIS> 

<Service_description>"Joe's Stage Productions Stuff Sales"</Service_description> 
<MulticalI> 
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CONTINUED FROM FIG. 1 0A 



<Autbentication> 

<Autbentication_code_description>"tbeater pin''</Autbentication_code_description> 
</Authentication> 

<Choices> 
<Choice> 

<Choice_description>C:\Mob\purchase_tbeater_video.wav</Choice_description> 
<Cboiee_value> 1 </Cboice_value> 
</Cboice> 

<Choice> 

<Chotce_descripiion>C:\Mob\purchase_playbill.wav</Cboice_description> 
<Cboice_value>2</Choice_value> 
</Cboice> 
</Cboices> 
</Multicall> 
</Service> 

</lncall Serviee> 
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Element: 


Outcall Service 


Attributes: 


title 


Children: 


Multicall | Percall 


Description: 


A container. A high level tag to mark the start and end of the XML file. Required. 






Element: 


Service 


Attributes: 


name 


Parents: 


Outcall Service 


Children: 


Service_description | Multicall | Percall | Reset 


Description: 


A container. The parameters in this container describe a service. There can be several services 
set up for Outcall. This tag allows the developer to group Multicall values. Required. 




Element: 


Multicall 


Parents: 


Service 


Children: 


Call_info | Introduction | Authentication | Content | Value_entry | Choices 


Description: 


A container. Indicates the parameters specified are to be used as default values for all the 
calls. Parameters set here act as default values for all calls until another multicall file is 
specified. Optional. 






Element: 


Percall 


Parents: 


Service 


Children: 


Call 


Description: 


M container, t/ontains tne list or cans to ne maae, one can per oan Tag. i\equireu it ho nuinodii 
tag specified. 






Element: 


Reset 


Parents: 


Service | Call 


Description: 


Resets values for parent tag and all its children tags already specified. Useful for canceling 
queued calls before they're made. Optional. 






Element: 


Call 


Attributes: 


id 


Parents: 


Percall 


Children: 


Call info | Introduction (Authentication | Content | Value_entry | Choices | Reset 


Description: 


A container. Contains information for a specific call. Required if there is a Percall tag. 






Element: 


Call info 


Parents: 


Multicall | Call 


Children: 


Phone number | Response_url | Ensure_completion 


Description: 


A container. Contains information about the call, beyond the dialog. Required in either Multicall 
or Call or both. 
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Element: 


Introduction 


Parents: 


Multicall | Call 


Children: 


Recipient I Sender 


Description: 


A container. Contains the information for the introduction portion of the call, the sender and 
the desired recipient. Required in either Multicall or Call or both. 






Element: 


Authentication 


Parents: 


Multicall I Call 


Children: 


Authentication_code_description | Authentication_code 


Description: 


A container. Contains tags that specif/ the information necessary for ensuring that the called 
party is the intended recipient of the call. Optional. Authentication is indicated if there is an 
authentication_code passed in from the customer's application. If there is an authentication_code, 
there must also be a description of that code and a recipient. 






Element: 


Content 


Parents: 


Multicall I Call 


Description: 


Audio. The content message to be played to the called party. The content may be an audio file 
(*.wav), a text file (*.txt), or raw text (enclosed in double quotes). Optional. 






Element: 


Value_entry 


Parents: 


Multicall | Call 


Attributes: 


mindigits | maxdigits 


Description: 


Audio. A description of the entry to be entered by the called party. Must fit carrier phrase, 
"Please enter..." and "You will be asked for..." Either Choices or Value_entry. but not both, 
may be specified. 






Element: 


Choices 


Parents: 


Multicall [ Calf 


Children: 


Choice | Transfer 


Description: 


A container. Contains information about the list of choices that will be presented to the user 
during the call. Either Choices or Value_entry, but not both, may be specified. Optional. 






Element: 


phone_number 


Parents: 


CalUnfo 


Description: 


Phone number to be called. Must include every digit that is to be dialed, (e.g., 9 to get an 
outside line, 1 for long distance). Required. 






Element: 


Response url 


Parents: 


CalUnfo 


Description: 


URL that Outcall service is to use to return status information about the call to the customer 
application. Optional. 
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Element: 


Ensure_completion 


Parents: 


Calljnfo 


Description: 


The number of times that Outcall service will call a person back, if the person has authenticated. 
These callbacks increase the likelihood of the completion of a desired call that was dropped 
accidentally (for instance, by the network). Optional. Default is 0. 






Element: 


Recipient 


Parents: 


Introduction 


Description: 


Audio. Usually text to be converted to speech. Fits the carrier phrase, "This is an automated 
call for <Recipient> from <Sender>." If Recipient is omitted from the XML, no authentication 
is done; rather, the called party is asked to press 1 to continue. Optional. 






Element: 


Sender 


Parents: 


Introduction 


Description: 


Audio. Fits the carrier phrase, "This is an automated call from <Sender>." Required. 






Element: 


Authentication_code_description 


Parents: 


Authentication 


Description: 


Audio. Description of the authentication code the party called will be asked to enter. Fits the 
carrier phrase, "Please enter <authentication_code_description>." For example. "Please enter 
your account number." Required for each Authentication tag. 






Element: 


Authentication_code 


Parents: 


Authentication 


Description: 


The digit string value of the called party's authentication code description. That is, the 




Authentication_code is the value that the called party must enter in order to continue with the 




call. Required for each Authentication tag. 






Element: 


Choice 


Parents: 


Choices 


Children: 


Choice_description | Choice value 


Description: 


A container. Describes the choices that are available to the called party. There is usually more 
than one Choice tag per Choices tag. Optional. 






Element: 


Transfer 


Parents: 


Choices 


Children: 


Transfer_description | Transfer number 


Description: 


A container. Describes the transfer option to the called party. If there is a transfer option, the 
value that the called party presses is "0" in order to transfer. Only one Transfer tag is allowed 
per Choices tag. Optional. 
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Element: 


Choice description 


Parents: 


Choice 


Description: 


Audio. Describes the option the called party may choose. Fits the carrier phrase, "If you would 
like <choice_description>, press 1 ." Required for each Choice tag. 






Element: 


Choice_value 


Parents: 


Choice 


Description: 


A single digit number that indicates the touch-tone that the called party should press in order to 
select the associated choice. Not that if there is a Transfer tag, "0" cannot be used for a 
Choice_value. Required for each Choice tag. 






Element: 


Transfer_description 


Parents: 


Transfer 


Description: 


Audio. Describes the person or thing the called party would be transferred to should they press 
zero. Required for each Transfer tag. 






Element: 


Transfer_number 


Parents: 


Transfer 


Description: 


The phone number to which the called party would be transferred, if they press zero. Required 
for each Transfer tag, 
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1 . Multi-call content definition file: OM 1 _short.xml 

This XML file defines a hypothetical outcall use case where ever called party will be 
presented with a short audio review of a movie. Then, users will be presented with a menu 
of two choices (purchase the DVD or purchase the video) or transferring to a call center. 

<?xml version- 1.07> 

<Outcafl service title="Outcall Test M file"> 

<Multicall> 

<Cail_info> 

<Response_url>http://vpl> 
mars/servlet/Outcall_serviceResponse</Response_url> 

</Call_info> 

<Content>C:\SmartOutcall\Sounds\princess_bride_x2.wav</Content> 
<Choices> 
<Choice> 

<Choice_description> 

C:\SmartOutcall\Sounds\purchase_DVD.wav 
</Choice_description> 
<Choice_value> 1 </Choice_value> 
</Choice> 
<Choice> 

<Choice_description> 

C:\SmartOutcall\Sounds\purchase_movie_video.wav 

</Choice_description> 
</Choice> 
<Transfer> 

<Transfer_description>"Kathy's phone"</Transfer_description> 
<Tran$fer_number>4939880</Transfer_number> 
</Transfer> 
</Choices> 
</Mufticall> 
</Outcall service> 
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2. Per-call IVR definition file: OPi.short.xml 3V ' ^ 

This XML file defines an outcall request using the current content definition (see the previous XML file) 
by specifying a 10-digit phone number to be called (925251 7200) and the 4-digit passcode (432 1) to 
determine if the person who answers the call is really "John Smith" as authorized to hear subsequent audio content. 

<?xml version- 1 .07> 

<Outcal! service title- 'Outcall Test P file"> 

<Percall> 

<Callid="12345"> 
<Call_info> 

<Phone_number>952525 1 7200</Phone_number> 
</Call_info> 
<Authentication> 

<Authentication_code_description> 
"your authentication code" 

</Authentication_code_description> 

<Authentication_code>432 1 </Authentication_code> 
</Authentication> 
<lntroduction> 

<Sender> "Test system"</Sender> 

<Recipient> "John Smith" </Recipient> 
</lntroduction> 

</Call> 
</Percall> 
</Outcall service> 

GENERIC DIALOG SAMPLE 

User: Hello 

System: Hello. This is an automated call for <Recipient> from <Sender>. If you are <Recipient>, 

please enter <Authentication_code_description> followed by the pound key. 
User: Enters <Authentication_code> 

System: I heard digits_entered If this is correct, press one. 

User: Presses 1 

System: Thank you. A message from <Sender> is next. Some important options follow the message. 

The message is less than one minute long. Beginning of message. <Content> End of message. 
That was your message. To hear the message again, press the star key. Please choose from 
one of the following #_choices choices. If you would like<Choice_description( 1 )>, press 
<Choice_value(1). If you would like <Choice_description(2), press <Choice_value(2)... 
If you would like to be transferred to <Transfer_description>, press 0. 

User: Enters 2 

System: To confirm that you would like <Choice_description(2)>, press one. 

User: Enters 1 

System: Your choices of <Choice_description(2)> has been confirmed. Thank you. Good-bye. 
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STATUS | 


UNLOCKED 

UNLOCKED 

LOCKED 

• 
• 
• 


DEVICE TYPE 


NOKIA 

PALM VII 

TOUCHPOINT 

• 
• 
• 


DEVICE ID 
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7714PM9 

447360W1 

• 
• 
• 
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• 
• 
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